home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / languages / ami_nuweb0.87c.lha / README < prev    next >
Encoding:
Text File  |  1994-10-08  |  1.5 KB  |  37 lines

  1. Here's an intermediate version of nuweb.  I've simply bundled up the
  2. web source (nuweb.w), the generated .c files, an abbreviated nuweb.tex
  3. file, and the assorted auxiliary files for latex'ing.
  4.  
  5. Note that it's still not completely portable to every system without
  6. change.  In particular, it expect file-names to use '/' to delimit
  7. directories and it still thinks tab stops are set every eight spaces.
  8. It also uses tempnam() which may not be available everywhere.
  9. tmpnam() might be made to work in some systems.  If all else fails,
  10. just use some adequately unlikely filename.
  11.  
  12. To print the documentation, you must first run latex on the file
  13. nuwebdoc.tex.  To fix up all the citations, you'll need several runs.
  14.  
  15.     latex nuwebdoc
  16.     bibtex nuwebdoc
  17.     latex nuwebdoc
  18.     latex nuwebdoc
  19.  
  20. Note that the distributed nuwebdoc.tex is basically Chapter 1 of the
  21. complete nuweb.tex generated by running nuweb against itself.
  22.  
  23. To actually build the nuweb executable, type "make nuweb" which should build
  24. an executable file called "nuweb".  After that, you should be able to
  25. use the makefile to control everything very nicely.
  26.  
  27. To view the nuweb sources using an HTML viewer, copy nuweb.w to
  28. nuweb.hw, and then add the html document-style option to nuweb.hw.
  29. After producing the LaTeX source file nuweb.tex, convert it to HTML
  30. using LaTeX2HTML.
  31.  
  32. If you have questions or comments (or just want the latest version),
  33. please let me know. I expect to continue working on the documentation
  34. for quite a while.
  35.  
  36. My e-mail address is preston@cs.rice.edu
  37.